From: Juanma Barranquero Date: Mon, 25 Dec 2006 01:07:10 +0000 (+0000) Subject: (Sorting Sequences): In sort*, add a little cautionary note about the key X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1~1^2~3187 X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=cc2757ec413e6da27a0e2a6dff117f4e9d8ac20f;p=emacs.git (Sorting Sequences): In sort*, add a little cautionary note about the key procedure being used heavily. --- diff --git a/man/cl.texi b/man/cl.texi index 56f81bb3947..2c357f5fec6 100644 --- a/man/cl.texi +++ b/man/cl.texi @@ -4092,7 +4092,9 @@ fed to the @var{predicate} function. For example, @noindent sorts @var{data}, a sequence of strings, into increasing alphabetical order without regard to case. A @code{:key} function of @code{car} -would be useful for sorting association lists. +would be useful for sorting association lists. It should only be a +simple accessor though, it's used heavily in the current +implementation. The @code{sort*} function is destructive; it sorts lists by actually rearranging the @code{cdr} pointers in suitable fashion.